IDLgrWindow::SetCurrentCursor
The IDLgrWindow::SetCurrentCursor procedure method sets the current cursor image to be used while positioned over a drawing area.
Syntax
Obj->[IDLgrWindow::]SetCurrentCursor [, CursorName] [, IMAGE=16 x 16 bitmap] [, MASK=16 x 16 bitmap] [, HOTSPOT=[x, y]]
Unix-Only Keywords: [, STANDARD=index]
Arguments
CursorName
A string that specifies which built-in cursor to use. This argument is ignored if any keywords to this routine are set. This string can either be a name provided to the REGISTER_CURSOR routine or one of the following:
|
ARROW |
CROSSHAIR |
|
ICON |
IBEAM |
|
MOVE |
ORIGINAL |
|
SIZE_NE |
SIZE_NW |
|
SIZE_SE |
SIZE_SW |
|
SIZE_NS |
SIZE_EW |
|
UP_ARROW |
|
Keywords
IMAGE
Set this keyword to a 16x16 column bitmap, contained in a 16-element short integer vector, specifying the cursor pattern. This image can be created from a string array using the CREATE_CURSOR procedure. The offset from the upper-left pixel to the point that is considered the “hot spot” can be provided via the HOTSPOT keyword.
MASK
When the IMAGE keyword is set, the MASK keyword can be used to simultaneously specify the mask that should be used. In the mask, bits that are set indicate bits in the IMAGE that should be seen and bits that are not are “masked out”.
HOTSPOT
Set this keyword to a two-element vector specifying the [x, y] pixel offset of the cursor “hot spot”, the point which is considered to be the mouse position, from the upper left corner of the cursor image. This parameter is only applicable if IMAGE is provided. The cursor image is displayed top-down (the first row is displayed at the top).
STANDARD
This keyword is only available on UNIX platforms.
Set this keyword to an X11 cursor font index to change the appearance of the cursor in the IDL graphics window to a glyph in this font. On non-X platforms, setting this keyword displays the crosshair cursor.
Version History
|
5.0 |
Introduced |
|
5.6 |
Added CursorName argument |